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Description Call this function to get a list of brief show information for a given range of channel numbers and 
time frame. The returned show array is sorted in the order of channel number and show 
beginning time. 

Prototype Boolean EPGChannelLineup(const line up & sline, show_info * const sinfo, int * const sorder, 
int &length5 query_error & err); 
Parameters •sline: IN PARAMETER. This structure specifies time grids and the range of channel numbers. 
The data structure is defined as: 
struct line up 

{ 

time_t time_grid_start; 
time_t time_grid_end; 
int channel_id_start; 
int channel_id_end; 

} 

• sinfo: OUT PARAMETER, sinfo is an array of type showjnfo. 

struct showinfo 

{ 

int channelnumber; 
charcall_letter[9]; 
time_t begin__time; 
short duration; 
unsigned char catjndex; 
unsigned char sub cat index; 
char short Jitle[22]; 
long reference_number; 

} 

• sorder: OUT PARAMETER. It stores the order of shows sorted in channel number and time. For 

example, sinfo[sorder[0]] is the first show, sinfo[sorder[l]] the second, etc. 
•length: IN OUT PARAMETER. As an in parameter, length is the dimension of sinfo and sorder, 
as an out parameter, it is the actual number of shows stored in sinfo and sorder, provided the 
number is less than the input length. Otherwise, FALSE is returned and err is populated with 
messages. 

•Err: OUT PARAMETER. This parameter holds error information if error occurs. Non-zero 
en code means something wrong in the call. Query_error is defined as 
struct query_error 

{ 

int err code; 
char err_msg[100]; 

} 

Return TRUE: Success 
Value FALSE: Fails to prepare tables for data loading 

2. EPGShowDescription 

Description This function returns a detailed show data. In order to get detailed show info, caller needs to pass 
the beginning time (or date) and reference number of the show. Reference number of a show is 
obtained by calling EPGChannelLineup function. 
Prototype Boolean EPGShowDescription(show_brief Jnfo &sbrief, show_description & sdesc, query_error 
&err); 

Parameters • sbrief: IN PARAMETER. The struct show briefjnfo is defined as 

{ 

time_t date; 

long reference number; 



FIG. 6B 

} 

• sdesc: OUT PARAMETER. Detailed description of a show, including category, description, 
etc. The data structure is defined as 

struct show_description 

{ 

char rest__of_title[100]; 
char short_description[64]; 
char description[801]; 
char category[13]; 
char subcategory[13]; 
short year jroduced; 
float stars; 
bool re_run; 
bool live; 

bool closed_caption; 
bool stereo; 
char tv_rating[13]; 
char n]paa_rating[5]; 

} 

• err: OUT PARAMETER. 
Return TRUE: Success 

Value FALSE: Fails to prepare tables for data loading. 



EPGFilter 
Description 

Prototype 

Parameters 



Return 
Value 



To get a list of shows having specified category-index and subcategory-index. Category-index 
and subcategory-index are numbers between 0 to 15. 

Boolean EPGFilter(show_cat_info &scat, show_info * const sinfo, int * const sorder, int &length, 
query__error & err); 

• scat: IN PARAMETER. The data struct show_cat_info is defined as 
struct show cat info 



{ 



} 



short cat_index; 
short subcatindex; 
timet begin_time; 
unsigned char updown_flag; 



Above data structure specifies category index, subcategory index, beginning time of a 
search, and forward or backward search flag. updown_flag=l means forward search, 0 
means backward search. The search is limited among the shows of the same day as the 
specified beginning time. 

• sinfo: OUT PARAMETER, sinfo is an array of type show_info. 

• sorder: OUT PARAMETER. It stores the order of shows sorted in channel number and 
time. For example, sinfo [sorder [0]] is the first show, sinfo [sorder [1]] the second, etc. 

• length: IN OUT PARAMETER. As an in parameter, length is the dimension of sinfo and 
sorder, as an out parameter, it is the actual number of shows stored in sinfo and sorder, 
provided the number is less than the input length. Otherwise, FALSE is returned and err is 
populated with messages. 

• Err: OUT PARAMETER. This parameter holds error information if error occurs. Non-zero 
err_code means something wrong in the call. 

TRUE: Success 

FALSE: Fails to prepare tables for data loading. 
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API for Data Loader 

1 . TsipCallback: :StartLoading 



FIG. 8A 



Description 



Prototype 
Parameters 
Return 
Value 



StartLoading is responsible for preparing database tables for the data loading. Therefore, this 
function must be called before data loading. After data loading is done, EndLoading function 
shall be called. 
Boolean StartLoadingQ 
None 

TRUE: Success 

FALSE: Fails to prepare tables for data loading. 



2. TsipCalIback::StartSip 



Description 



Prototype 
Parameters 
Return 
Value 



StartSip marks the beginning of the data loading of a show information packet. A show 
information packet contains 4-hour show data for one channel. EndSip indicates the end of the 
data loading of one packet. 
Boolean StartSipQ 
None 

TRUE: Success 

FALSE: Fails to prepare tables for data loading. 



3. TsipCallback: : WriteSip 



Description WriteSip inserts one or couple of show data into database tables. 
Prototype Boolean WriteSip(const SipHeader &shdr, const Showinfo *psi, int length) 



Parameters • 



shdr: IN PARAMETER. SipHeader contains common data shored by show data stored in 

the array Showinfo, 

struct 

TUNECHAN { 

unsigned char type; 



unsigned short minor; 
unsigned short major; 

} 

struct SipHeader 

{ 



//bO-2: 0:OTA Lcable 2:satellite 3-7:reserved 
// b3:digital b4:dual A/B cable trunk b5-7:rsvd 
// up to 10 bits of digital minor channel 
// up to 10 bits of digital major channel, or analog channel 



short channel_id; // unique channel ID 

TUNECHAN tune_channel; // see struct definition above 

char channel_name[9]; // (null terminated string) 

unsigned char day_of_week; // 0,1,2,6 for Sun, . . Saturday, respectively 

char date[9] ; // YYYYMMDD null terminated 

// on 4 hour intervals (0, 4, 8, 12, 16, 20) 

} 

psi: IN PARAMETER. Showinfo is defined as 
struct Showinfo 

{ 

char short_title[22]; // short title, as displayed on grid titles 
char rest_of_title[100]; //concatenated with short title, the complete show title 
char short_description[64]; // short description. Enough descriptive text to fit 3x21 
// display, (includes ratings for movies, teams for sports, 
// subjects for talk shows, etc. char null terminated, 
char long_description[801]; // with short description, complete description 
// null terminated 

charbegin_time[15]; 
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// Show starting time with format of YYYYMMDDHHMI 

// null terminated. MM takes a value of 01, . . 12; 

// DD takes a value of 01, , . 31 ; HH takes a value of 00, . . 23; 

// MI takes a value from 00 to 59. 
char end_time[15]; // as above, used for performance purpose 
int duration; // in minutes 

char category[i3]; // category name, null terminated 
unsigned char cat_index; 

char subcategory[13]; // sub-category name, null terminated 
unsigned char sub cat index; 

short year_produced; // four digits, e.g., 1998. For search purpose 
float stars; // 0, 0.5, 1 , 1 .5, 2, . . 4.5, 5 for search purpose 

bool re_run; 
bool live; 

bool closed_caption; 
bool stereo; 

char TV__rating[13]; // "TVMA-FVDLVS", "TVY-LV", null terminated 
char mpaa_rating[5]; // ''NCI 7', "X", . . ., null terminated 

}; 

psi is the pointer of the array Showinfo psi[length]. 
• length: IN PARAMETER, length tells how many show records in the array psi. 



Return TRUE: Success 
Value FALSE: Fails to prepare tables for data loading. 



TsipCallback::EndSip 

Description EndSip noarks the end of the data loading of a show information packet. 

Prototype Void EndSip() 
Parameters None 
Return Void 
Value 



TsipCallback: :EndLoading 

Description After data loading is successfully completed, Data Loader calls EndLoading to invoke a sequence 
of actions on the database tables, such as clean up temporary tables and etc. If, for some reason, 
this API is not called, then show data for UI will not be updated. 
Prototype Void EndLoading() 
Parameters None 
Return Void 
Value 
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API for Channel Mapping 
1. MapGet 
Description 



This function returns an array of Channel Mapping data to the caller. Channel Mapping describes 
the mapping among Channel, Call letter, Category, and Channel Id, 
Prototype Boolean MapGet(channel_map * const minfo, int * const sorder, int &length, query_error & err) 
Parameters • minfo: OUT PARAMETER. The pointer minfo points to an array of channel_map. The 
struct channel map is defined as 
struct channel_map 

{ 

char callletter[9]; 
unsigned short channel id; 
unsigned short channel; 
unsigned short cat; 

}; 

• sorder: OUT PARAMETER. It stores the order of Channel Mappings sorted in channel 
number. 

• length: IN OUT PARAMETER. As an in parameter, length is the dimension of minfo and 
sorder, as an out parameter, it is the actual number of shows stored in minfo and sorder, 
provided the number is less than the input length. Otherwise, FALSE is returned and err is 
populated with messages. 

• Err: OUT PARAMETER. This parameter holds error information if error occurs. Non-zero 
err_code means something wrong in the call. 

Return TRUE: Success 
Value FALSE: Fails to prepare tables for data loading. 



2. MapSet 
Description 



Prototype 
Parameters 



Return 
Value 



Caller can set Channel Information by calling this function. Inside of MapSet, it checks each 
element of the array minfo against the records in the database. If the call letter exists in the 
database, then update the row by the new data from minfo; if call letter doesn't exist in the 
database, then insert a new row into the database. 

Boolean MapSet(channel_map * const minfo, int &length, query_error & err) 
• minfo: IN PARAMETER. The parameter minfo is an array of channel_map. The struct 

channel map is defined as 

struct channel_map 



{ 



}; 



char calMetter[9]; 
unsigned short channel id; 
imsigned short channel; 
unsigned short cat; 



• length: IN PARAMETER. It is the actual number of Channel Mappings stored in minfo. 

• Err: OUT PARAMETER. Non-zero err_code means something wrong in the call. 
TRUE: Success 

FALSE: Fails to prepare tables for data loading. 



3. MiniGuideGet 

Description To get Mini Guide data. Mini Guide shows the mapping between Category and Channel. At 
present, there are about 12 categories. Each Category owns a segment of Channels. 
Prototype Boolean MiniGuideGet(mini_guide * const minfo, int * const sorder, int &length, query_error & 
err) 
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Parameters • minfo: OUT PARAMETER, minfo is an array of mini guide. The data struct inmi_guide is 
defined as 
struct 

{ 

char name[15]; // Category 

unsigned short channel; // Channel Number 
unsigned short offline; // Channel number starts at 
unsigned short start; // Channel segment starts at 
unsigned short end; // Channel segment ends at 

unsigend short dup start; // Local Channel starts at 

} 

• sorder: OUT PARAMETER. The order of Mini Guides by channel number. 

• length: ESf OUT PARAMETER. As an in parameter, length tells the dimension of minfo and 
sorder, as an out parameter, it is the actual number of Mini Guides stored in minfo and 
sorder, provided the number is less than the input length. Otherwise, FALSE is returned. 

• Err: OUT PARAMETER. Non-zero err_code means something wrong in the call. 
Return TRUE: Success 

Value FALSE: Fails to prepare tables for data loading. 



MiniGuideSet 
Description 



Prototype 
Parameters 



Return 
Value 



Caller can set Mini Guides by calling this function. Inside of MiniGuideSet, each element of the 
array minfo is checked against the records in the database. If a category exists in the database, 
then update the row by the new data from minfo; if a category doesn't exist in the database, then 
insert a new row into the database. 

Boolean MiniGuideSet(mini_guide * const minfo, int &length, query error & err) 

• minfo: IN PARAMETER. The pointer minfo points to an array of mini guide. 

• length: IN PARAMETER. It is the actual number of Mini Guides stored in minfo. 

• Err: OUT PARAMETER. Non-zero err_code means something wrong in the call. 
TRUE: Success 

FALSE: Fails to prepare tables for data loading. 
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.struct adr_hdr; 

■r,. { 

char_name[30]; 
char f_name[30]; 
char c_date[15]; 
long t_row; 
long a_row; 
long na_row; 
short hdr_len; 
short row_start; 
short row_len;; 
short row_hdr_len; 
short row_bdy_len; 
short row_hdr_start; 

}; 

where 

• Name: Table name 

• C_date: When the table is created, in the form "YYYYMMDDHHMISS" 

• F_name: the file where the data is stored 

• T_row: Total number of initialized rows 

• Na_row: Next available row id for insertion 

• Hdr_len: length of the header 

• Row_start: where the data (row) start (=hdr_len); 

• Row_len: the length of a row 

• Row_hdrJen: length of the row header 

• Row bdy len: the length of the row-body 

• Row_hdr_start; Where the row-header starts 

Struct row_hdr 

{ 

long row_id; 

long next_available_row; 

char usage; 

} 

where 

• Row_id: row id of the row. Increased by one each time 

• Next_avaialble_row: row id of the next available row for insertion, 

• usage: 'N' means available; ' Y' means used. 
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